Action Constants
Each individual action in an action list is contained by an atom of type
kActionAtom
. Its child atoms define which action it is, what target in the movie it operates on, what the values of each of its parameters are, and any parameter options for each parameter.
Since each action is intended to be sent to a particular type of target, the action constants are explained below, grouped by their target type.
If minimum and maximum values are not specified, then they may be assumed to be the full range of the parameter's data type.
Constant descriptions
-
kAction
-
This atom is a container for a single sprite action. Add an atom of this type for each action in an action list. The list of actions will be executed in order, based on the index of these atoms, from one to the number of
kAction
atoms present. The IDs may be any unique IDs. This atom's parent type is commonly
kQTEventType
. It may also be a child atom of a
kQTEventFrameLoaded
atom, and of a
kActionListAtomType
atom for nested action lists.
-
kWhichAction
-
This atom specifies the type of action that will be executed. Add a child atom of this type to each
kAction
atom, setting its ID to 1. The atom's leaf data is a
long
which contains the constant describing which action to execute. For example, to create a set movie volume action, set the leaf data of the
kWhichAction
atom to
kActionMovieSetVolume
.
-
kCommentAtomType
-
This atom allows you to comment an action or an event in a language independent manner. Tools which decompile action lists may choose to display these comments. You may add any number of comments to each action or event. The order is defined by the atom index.
-
The parent atom type of the
kCommentAtomType
is either
kAction
,
kQTEventType
, or
kQTEventFrameLoaded
. The leaf data is a C string.
© 1999 Apple Computer, Inc.| Previous | Chapter Contents | Chapter Top | Next |